Ektron CMS400.Net Reference

>>Using Widgets > Creating Conditions with the Targeted Content Widget > Creating a Targeted Content Widget

Creating a Targeted Content Widget

To create a Targeted Content widget, follow these steps.

Prerequisite:  The Targeted Content widget must be on the list of widgets assigned to the page's template. See Also: Adding the Wireframe and Widgets into the CMS

  1. Drag and drop the Targeted Content widget onto a PageBuilder page.
  2. By default, Condition 1 is added to the widget. Click Edit Condition.
  3. Give the condition a name.
  4. Click +or to set up the first condition.
  5. A dropdown list of condition criteria appears.

    The following table describes the criteria options.

    Criterion

    Use this criterion to specify widgets that will appear if

    Search Engine

    If the site visitor was referred to this page from any search engine (or not)

    Or

    If the search engine from which the site visitor was referred is one of the following

    - Google

    - Bing

    - Yahoo

    - Other

    - None

    Or

    If the search engine's keywords are (are not, contain, start with, or end with) a specified value

    Referring URL

    The referring host matches a string value (for example, www.example.com).

    This is helpful for determining the site from which a visitor came to your site, such as a Facebook fan page.

    URL parameter

    The current page contains the specified URL parameter.

    For example, you create a campaign selling gold jewelry and base its content on the URL parameter cid=gold.

    If the URL of the page that hosts the Targeted Content widget contains cid=gold (for example, http://www.mystore.com/product.aspx?cid=gold), then display widgets assigned to that Targeted Content widget.

    Cookie

    A cookie matching the specified pattern is found on the site visitor's computer.

    Cookies are generally stored as name value pairs, such as UserID - A9A3BECE0563982D. When checking for a cookie, you complete three fields.

    cookie ID

    logic (is, is not, contains, starts with, ends with)

    a value

    For example, if a certain campaign placed cookies beginning with A9A, you would set up the criterion like this:

    Note:  The cookie criterion does not support subkeys, such as ecm.userid or ecm.sitepath.
    To work around this problem, use a contains operator and enter the text following .ecm, such as sitepath.

    Device Configuration

    The user's device matches a Device Configuration that you specify. For example, a content block displays only if a user accesses your Web site with a Smart Phone.

    To learn about Device Configurations, see Adding a Device Configuration and Supporting Mobile Devices.

    Logged inThe user is or is not logged in.

    User is in group

    Note:  Only applies to logged-in users.

    User is member of a Ektron CMS400.NET User or Membership Group that you select from dropdown list. See Also: Membership Users and Groups, Managing User Groups

    User is in community

    Note:  Only applies to logged-in users.

    User is a member of an Ektron CMS400.NET Community Group that you select from dropdown list. See Also: Community Groups

    User Properties

    Note:  Only applies to logged-in users.

    The value of the logged-in user's custom property satisfies the logic for the value you specify. See Also: Custom User Properties

    Example:

    Zip code is a Custom User Property. You want to display a list of stores in New Hampshire for users whose Zip Code begins with 03.

    Condition / result

    Zip code = 03458 true

    Zip code = 02103 false 

    Date and Time: Day

    The actual date (according to the web server's clock) and a date you enter satisfy the specified logic.

    Logic operators:

    is

    is not

    less than

    greater than

    equal to or less than

    equal to or greater than

    Examples:

    Assume today's date is 2010-01-01

    Condition / result

    Date = 2010-01-01 true

    Date < 2010-01-01 false

    Date >= 2009-12-01 true

    Date and Time: Day of Week

    The current day (according to the web server's clock) satisfies the specified logic.

    Logic operators:

    is

    is not

    Examples:

    Assume today's date is 2010-03-01 (Monday)

    Condition / result

    Day of week is Monday true

    Day of week is Tuesday false

    Day of week is not Tuesday true

    Date and Time: Day of Month

    The actual date (according to the web server's clock) and a date you enter satisfy the specified logic.

    Logic operators:

    is

    is not

    less than

    greater than

    equal to or less than

    equal to or greater than

    Examples:

    Assume today's date is 2010-03-01 (Monday)

    Condition / result

    Day of month is 01 true

    Day of month is not 01 false

    Date >= 2009-12-01 true

    Date and Time: Hour of Day

    The actual hour (according to the web server's clock) and number between 1 and 23 you enter satisfy the specified logic. The numbers are based on a 24 hour clock so, for example, 5 p.m. is 17.

    Logic operators:

    is

    is not

    less than

    greater than

    equal to or less than

    equal to or greater than

    Examples:

    Assume current time is 18:30:00

    Condition / result

    Hour of day is 18 true

    Hour of day is 23 false

    Hour of day >= 12 true

    User Regional Info

    Enter the user's country or state, or both. State selections are limited to states in the United States.

    This information is retrieved from the IP address of the person who is using your Web site. In order to retrieve this information, you need to enable eWebEdit400's Using GeoIP Information in Ektron CMS400.NET.

    Facebook Info

    If the criterion matches information in the user's Facebook profile, display the widgets inserted into this condition.

    For example, if the criterion is Marital Status is Single and the user's Facebook Profile matches that value, display the assigned widgets.This criterion only works with users who log in via Facebook Login.

    You can apply any of these facebook fields.

    Age

    Gender

    Marital Status

    Likes

    Employment

    Use Contains with Free Text Fields

    On fields that use free text (such as Likes), Ektron recommends using the contains operator, as opposed to is or is not. Contains is more flexible and finds a partial match.

    For example, if the user likes U.S. Soccer and you enter the term soccer and the contains operator, a partial match is made, so the user sees the related widget.

    On the other hand, if the user likes U.S. Soccer and you enter the term soccer and the ioperator, an exact match is not made, so the user does not see the related widget.

    The Likes Field

    The Likes field lets you search through users' Facebook profile Likes and Interests. Or, you can narrow it down to a specific like/interest. For example, you could display a widget promoting Red Sox merchandise if, in their Facebook profile, users like a Sports Team that contains Red Sox.

    Otherwise

    No condition evaluates to true.

    Note:  You would typically use this criterion last, since it always evaluates to true. Any conditions below this are ignored.

  6. Add additional criteria as desired. See Also: Creating a Targeted Content Widget
  7. Click Save.
  8. Drag to the area below the new condition one or more widgets that appear if the condition evaluates to true.
  1. If the widget requires you to fill out properties, click Edit () and complete the screen. See example below.

See Also: Widget Reference


Visit the Ektron Dev Center at http://dev.ektron.com 1-866 - 4 - EKTRON

Ektron CMS400.NET Reference Version 8.02 SP1 Rev 1

Ektron Documentation,© 2011 Ektron, Inc.